XTA-Profile verwalten

Beachten Sie, dass die Einträge je nach eingesetzter XBau-Version variieren können.

Profile für XTA-Postfächer werden im Verwaltungsmodul unter XTA-Profile angelegt. In diesen Profilen legen Sie die Transporteinstellungen für den XTA-Service fest, um die reibungslose Zusammenarbeit der Systeme über XBau-Nachrichten zu gewährleisten.

Zum Anlegen von XTA-Profilen ist eine Lizenz eines elan-Moduls erforderlich. Ohne diese Lizenz wird die Schaltfläche nicht angezeigt.

Zusätzlich können Sie XTA-Profile nur verwalten, wenn Sie in der Rechteverwaltung unter PROSOZ Bau > eGovernment > Benutzer darf XTA-Profile verwalten das entsprechende Recht Benutzer darf XTA-Profile verwalten haben. Beachten Sie auch den Hinweis auf der Rechteseite im Programm.

Parameter

Transporteinstellungen

Die Daten mit * müssen von der Gegenstelle zur Verfügung gestellt werden.

Bezeichnung Bezeichnung des Postfaches innerhalb von PROSOZ Bau.

XTA-Send* Hier wird die Adresse des Endpunktes für das Versenden von XTA-Nachrichten eingetragen.

XTA-Fetch* Hier wird die Adresse des Endpunktes für das Empfangen von XTA-Nachrichten eingetragen.

XTA-Management* Hier wird die Adresse des Endpunktes für die Verwaltung von XTA-Nachrichten eingetragen.

XTA-Sender* Hier wird ein Transportparameter für den XTA-Header eingetragen. i.d.R. der „Absender auf dem Briefumschlag“ an die Behörde.

XTA-Reader* Hier wird die Bezeichnung für den adressierten Sender eingetragen.

PartyIdentifier* Hier stellen Sie ein, wie die Kommunikationsparameter des XTA-Empfängers adressiert bzw. abgerufen und verarbeitet werden. Er dient bei der Autorisierung zur Identifikation des Kommunikationspartners. Als Default wird UserAdministration gewählt. Siehe auch: https://www.xrepository.de/details/urn:de:xta:codeliste:type.of.party.identifier

Bei elan comfort (SaaS) mit XBau Version 2.2 muss dieses Feld leer bleiben!

Antragsteller/Subject des Empfängerzertifikats Hier wird der Antragsteller für das zu verwendende Zertifikat für den Empfang von Nachrichten eingetragen. Es handelt sich um ein privates Clientzertifikat des XTA-Server und kann abweichen vom DVDV-Zertifikat (z. B. Niedersachsen, Bayern)!
Beispiel: SSL Bauaufsichtsbehörde Musterstadt (bab:01234567)

bab gilt bei einem Versand von Behörde zu Behörde. Bei einem Versand von oder zu einen Bauportal verwenden Sie bap – Bauportal. D.h., wenn etwas vom Bauportal zur Behörden geschickt wird bap zu bab und wenn der Versand von der Behörde zum Portal läuft bab zu bap.

Das Subjekt des Zertifikates muss exakt und vollständig übernommen werden.

Bei Zertifikat mit komplexem Namen

Bei Zertifikaten mit komplexen Namen (z.B. bei einem Namen mit vollständigen X.509 Namensschema) kann es vorkommen, dass das Zertifikat nicht mehr vom XTA-Service gefunden wird.

Im PROSOZ Bau Systemcheck Hilfe > Systemcheck unter XTA-Service > Ablaufdatum Zertifikat, wird in diesem Fall ein Fehler angezeigt.

Gehen Sie nun wie folgt vor:

Starten Sie eine PowerShell auf dem Computer auf dem der XTA-Service installiert ist und zeigen Sie alle Installierten Zertifikate an: Get-Item Cert:\LocalMachine\My\*
Identifizieren Sie das Zertifikat, das vom XTA-Service genutzt werden soll, z.B. CN=elan, S=Bundesland, O=Stadt Musterstadt, OU=Bauamt.
Kopieren Sie das Subject des gewünschten Zertifikates in die Zwischenablage.
Sollte das Subject mit „…“ enden, dann wurde ein Teil der Ausgabe abgeschnitten und Sie müssen das PowerShell-Fenster vergrößern, und Get-Item Cert:\LocalMachine\My\* erneut ausführen.
Fügen Sie den kopierten Wert aus der Zwischenablage in der Feld Antragsteller / Subjekt des Empfängerzertifikats ein,
z.B. CN=elan, S=Bundesland, O=Stadt Musterstadt, OU=Bauamt.

Zertifikate werden gefunden:
- Der vollständige X.509 Name (mit mindestens einem Gleichzeichen)
- Ein Fingerabdruck
- Ein Text ohne Gleichzeichen

Versand der XBau-Nachricht 1120 blockieren? Wenn Sie den Haken setzen, versendet der XTA-Service nach Eingang einer XBau-Antragsnachricht keine Eingangsbestätigungsnachricht (XBau-Nachricht 1120) mehr.

Nach Änderung dieser Einstellung muss der XTA-Service neu gestartet werden, damit sie wirksam wird.

IsTestData Hier wird festgelegt ob es sich um ein Testsystem handelt. Im Echtsystem immer: Nein.

XTA-Profil anlegen

Klicken Sie im Verwaltungsmodul im Reiter System die Schaltfläche XTA-Profile .
Es erscheint die Liste der vorhandenen XTA-Profile.
Wählen Sie den Mandanten aus, für den das Profil eingerichtet werden soll.
Klicken Sie im Reiter Bearbeiten die Schaltfläche Neu .
Das leere XTA-Profil wird geöffnet.
Nehmen Sie nun die notwendigen Einstellungen vor, mind. jedoch die Pflichtfelder.
Klicken Sie abschließend Speichern .
Das XTA-Profil ist angelegt und gespeichert.
Um das XTA-Profil zu nutzen, müssen Sie es mit dem XTA-Empfänger verbinden, siehe XTA-Empfänger.

XTA-Profil bearbeiten

Klicken Sie im Verwaltungsmodul im Reiter System die Schaltfläche XTA-Profile .
Es erscheint die Liste der vorhandenen XTA-Profile.
Doppelklicken Sie das zu bearbeitende XTA-Profil oder markieren Sie es und klicken die Schaltfläche Bearbeiten .
Das markierte XTA-Profil wird geöffnet.
Nehmen Sie nun die Bearbeitung, gemäß der Parameterdefinition oben, vor.
Klicken Sie Speichern .
Die Änderungen im XTA-Profil sind gespeichert.

XTA-Profil löschen

Klicken Sie im Verwaltungsmodul im Reiter System die Schaltfläche XTA-Profile .
Es erscheint die Liste der vorhandenen XTA-Profile.
Markieren Sie das zu löschende XTA-Profil.
Klicken Sie im Reiter Bearbeiten die Schaltfläche Löschen .

Wenn ein verbundenes XTA-Profil gelöscht wird, erscheint eine Meldung "Es sind noch abhängige Einträge vorhanden" mit der Liste der verbundenen XTA-Empfänger.

Lösen Sie die Verbindungen zu den XTA-Empfängern, bevor Sie das XTA-Profil löschen können. Die Verbindung heben Sie im Parameter XTA-Empfänger auf, siehe XTA-Empfänger.

War der Artikel hilfreich?

Verwandte Themen

XTA-Empfänger

XTA-Service einrichten

Antragsstellung mit elan classic

XTA-Service - Anzeigen und Löschen reservierter URLs